home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Tampa Bay Amiga Group / TBAG - Tampa Bay Amiga Group's Disk of the Month #70 (1992)(Merlin's Software - Amiganuts United)(PD)[b corrupt file].zip / TBAG - Tampa Bay Amiga Group's Disk of the Month #70 (1992)(Merlin's Software - Amiganuts United)(PD)[b corrupt file].adf / ReadMe / muchmore.doc < prev    next >
Text File  |  1991-08-17  |  15KB  |  376 lines
  1.  
  2.  
  3.                         M u c h M o r e  V 2.5
  4.                      ============================
  5.  
  6.  
  7.                       © 1989 by Fridtjof Siebert
  8.                              Nobileweg 67
  9.                          D-7000-Stuttgart-40
  10.                      Federal Republic of Germany
  11.  
  12.  
  13.  
  14.   What is MuchMore?
  15.  
  16.     MuchMore is  another  program  like  More,  Less  etc.  that prints
  17.     ASCII-Files to the screen.  Unlike these, it opens its  own  screen
  18.     to show  the  text  and  to scroll it softly!  But not only softly,
  19.     MuchMore is also able to scroll very quickly if  you  want  it  to!
  20.     Furthermore,  there are commands to search for strings and to print
  21.     the text.  MuchMore will run on any  Amiga,  whether  it's  a  PAL,
  22.     NTSC, overscan  or  any Amiga in future.  Because MuchMore's screen
  23.     has no border, there are 80 characters displayed per line.
  24.  
  25.   Why MuchMore instead of MORE, BLITZ or LESS?
  26.  
  27.     Because MuchMore is just better :-). MuchMore (17K) is much shorter
  28.     than  LESS (28K).  BLITZ or other programs  that scroll  quickly or
  29.     softly   usually  use  2  Colors  and  don't  support  any  special
  30.     fontstyles.  MuchMore  instead  has  4 Colors  and  displays  bold,
  31.     italic,  underlined  and inverse  text. Unlike many other programs,
  32.     MuchMore uses the Font  that's set with SetFont if it's an 8x8 Font
  33.     instead of topaz 8.
  34.  
  35.     MuchMore is  ideal  to  display  long  texts.    The text is loaded
  36.     simultaneously while it  is   displayed.   That  is,  while  you're
  37.     reading  the first page, the rest of the text is loaded into memory
  38.     and you're able to move  through  the  text  quickly  then  without
  39.     re-loading it.
  40.  
  41.   How to start MuchMore:
  42.  
  43.     CLI:
  44.  
  45.       Just Type:
  46.  
  47.         MuchMore <FileName>
  48.  
  49.       FileName is the name of the  ASCII-Text  that is to be displayed.
  50.       If there  are any spaces in  the filename it  must be enclosed by
  51.       quotes. "MuchMore ?" displays  the usage.  If MuchMore is started
  52.       without an argument and the arp.library is installed, it will ask
  53.       for the filename using arp's filerequester. 'MuchMore -s'  starts
  54.       MuchMore and sends it  to sleep immediately  until left alt & ESC
  55.       is pressed. Then  ARP's filerequester  is used  to get  the texts
  56.       name.
  57.  
  58.     Workbench:
  59.  
  60.       Just click the text to be printed with your mouse and then shift-
  61.       doubleclick MuchMore.
  62.  
  63.       Texts with  MuchMore as  their  default-tool (e.g.  ":c/MuchMore"
  64.       when MuchMore has been copied to the disk's :c/ directory) can be
  65.       displayed easily by doubleclicking them.
  66.  
  67.   MuchMore's commands:
  68.  
  69.     The commands are activated simply by pressing their keys:
  70.  
  71.       Space or left mousebutton:
  72.  
  73.                  Stops  or  restarts  scrolling.   While  scrolling  is
  74.                  stopped  the  filelength,  linenumber  and the current
  75.                  percentage of the text are displayed in the bottommost
  76.                  line.
  77.  
  78.                  Pressing space at the end of the texts quits MuchMore.
  79.  
  80.       BackSpace or right mousebutton:
  81.  
  82.                  Stops or restarts  backwards  scrolling. Works similar
  83.                  to the Space-Key.
  84.  
  85.       Up/Down or 2/8 of the numeric keypad:
  86.  
  87.                  Scrolls one line up or down.
  88.  
  89.                  If you  press these  keys together  with the shift-key
  90.                  you can start and stop fast scrolling.
  91.  
  92.                  Alternate plus these keys scroll one page up or down.
  93.  
  94.       PgUp / PgDn (numeric keypad):
  95.  
  96.                  Scroll up or down one page.
  97.  
  98.       T (top) or Home:
  99.  
  100.                  Moves to top of text.
  101.  
  102.       B (bottom) or End:
  103.  
  104.                  Moves to bottom of text.
  105.  
  106.       F (find):
  107.  
  108.                  Waits for a string to be entered and searches for this
  109.                  string   starting   at   the  topmost  line  currently
  110.                  displayed on   the   screen.       The    search    is
  111.                  case-insensitive.   If  the  string is found, the line
  112.                  containing the string will  be displayed and the found
  113.                  string  will  be highlighted.  Else  the  screen  will
  114.                  display a beep.
  115.  
  116.       N (next):
  117.  
  118.                  Searches for the next  occurance of the string entered
  119.                  with `F'. See above.
  120.  
  121.       P (previous):
  122.  
  123.                  Searches  for  the  previous  occurence  of the string
  124.                  entered with `F'. It  starts  with  the  topmost  line
  125.                  that's currently displayed and searches backwards.  If
  126.                  the  search  is  succesful,  the  line  containing the
  127.                  string will be displayed like it is by the  F-Command.
  128.                  Else a beep will be displayed.
  129.  
  130.       Shift + Fn:
  131.  
  132.                  Shift plus one of F1 to F10  sets a text marker at the
  133.                  current position.
  134.  
  135.       Fn:
  136.  
  137.                  Jumps to the text marker #n that's been set with Shift
  138.                  plus Fn.  If text marker #n isn't set yet,  it will be
  139.                  set to the current position,  as it would have been if
  140.                  you had pressed shift plus Fn.
  141.  
  142.       G (goto):
  143.  
  144.                  Opens a Window  with an integer-gadget.  You can enter
  145.                  the number of the line that is to be displayed.
  146.  
  147.       Shift + Alt + O (printout):
  148.  
  149.                  Prints the  text.    This  is  done with "TYPE text TO
  150.                  PRT:".  So  it  works  with  any  printer   when   the
  151.                  preferences are  set correctly.  The commands TYPE and
  152.                  RUN must occur in the current C: directory.  You don't
  153.                  have to wait while printing.  You can continue reading
  154.                  the text with MuchMore. I hope that it  is  impossible
  155.                  to  press shift+alt+o accidentally, so you won't print
  156.                  a 100k text when you in fact don't  need  a  printout.
  157.                  The printing cannot be interrupted, but you can switch
  158.                  off  your  printer  and  wait  for the printertrouble-
  159.                  requester :-).
  160.  
  161.       W (write):
  162.  
  163.                  Writes the  text that's marked between the textmarkers
  164.                  that have been set with F1 and F2 to a file or to PRT:
  165.                  when  you  accept the  default filename.  The text  is
  166.                  saved starting at  the topmost line of the page marked
  167.                  with  F1 until  the bottommost line of  F2's page.  To
  168.                  print  the  current   page  you  just  press  Shift+F1,
  169.                  Shift+F2, w and RETURN.
  170.  
  171.       L (load):
  172.  
  173.                  Opens the arp-filerequester and loads a new text. This
  174.                  command does  only work if the  arp.library is present
  175.                  in the current libs: directory.
  176.  
  177.       HELP or H:
  178.  
  179.                  Shows all  MuchMore-Commands.  This way  everybody who
  180.                  doesn't have this documentation file should be able to
  181.                  use  MuchMore.  After  pressing  any  key  the text is
  182.                  displayed again.
  183.  
  184.       ESC, Q, X or 5 of the numeric keypad:
  185.  
  186.                  Quit MuchMore.
  187.  
  188.       S (sleep):
  189.  
  190.                  Closes MuchMore's Screen and waits until left alt plus
  191.                  ESC is pressed.  Then arp's  filerequester is  used to
  192.                  get the text's name like it is within the 'L' command.
  193.                  It is not  possible to send  more than one MuchMore to
  194.                  sleep.
  195.  
  196.  
  197.   The Files in this package:
  198.  
  199.     MuchMore            The executable
  200.     MuchMore.ReadMe     This textfile
  201.     MuchMore.LiesMich   German documentation
  202.  
  203.     src (dir)           This directory contains the source:
  204.  
  205.       MuchMore.imp      The OBERON Source
  206.       MMQText.asm       sources of the  assembler procedures (A68k)
  207.       MMInput.asm       assembler source of MuchMore's InputHandler
  208.       MuchMore.lnk      BLink-With file to link MuchMore
  209.       Dos.obj           \
  210.       Graphics           \     object
  211.       Intuition.obj       \     files
  212.       MMQText.o            \     of
  213.       MMInput.o            /     all
  214.       MuchMore.obj        /    needed
  215.       OberonLib.obj      /     modules
  216.       Workbench.obj     /
  217.  
  218.     All files apart from the objectfiles have an icon.
  219.  
  220.  
  221.   Copyright:
  222.  
  223.     MuchMore is free to be spread on public-domain and shareware disks,
  224.     as  long as they are sold for a reasonable charge that is less than
  225.     $6 or DM 8.-.  It  may  be  used  there  to  display   readme-  and
  226.     documentation-files. My name has to be left in the program (HELP).
  227.  
  228.     Although MuchMore is not Shareware, donations are welcome.
  229.  
  230.     It's not allowed to use this in a commercial way without my written
  231.     permission.  This permission is  also  necessary  if  you  want  to
  232.     publish MuchMore as a part of a commercial product.
  233.  
  234.     If you change anything in my source you're allowed to put your name
  235.     in the program's head (:History.), but leave my name in!  If you've
  236.     made  any  enhancements,  please  send them to me (else there'll be
  237.     thousands of different versions).
  238.  
  239.  
  240.   Mail:
  241.  
  242.     If you have any comments, donations,  questions or PD programs just
  243.     send them to me! If possible, also send the return postage.
  244.  
  245.  
  246.   Compile:
  247.  
  248.     MuchMore  is written  in OBERON  using the  compiler  I'm currently
  249.     writing :-). This compiler  creates better code  then the Modula-II
  250.     compiler I used  before, so I  ported MuchMore  to OBERON.  But the
  251.     compiler is  not complete yet  and it currently doesn't fit Wirth's
  252.     OBERON standard. E.g. it's memory management is  similar to that of
  253.     Pascal and type extensions are currently  not supported at all. But
  254.     it's code is quite good.
  255.  
  256.     The compiler  is not public domain  and it can't be bought anywhere.
  257.     So currently noone apart from me is able to compile MuchMore. If you
  258.     want  to make  any changes  and  recompile it  yourself  you have to
  259.     translate  it to  Modula-II or you  must use  MuchMore V1.8 which is
  260.     written using the M2Amiga compiler.
  261.  
  262.  
  263.   Revisions:
  264.  
  265.  
  266.    v1.0:
  267.  
  268.       - this version was terribly slow and therefore not published!
  269.  
  270.    v1.1:
  271.  
  272.       - first published version.
  273.  
  274.    v1.2:
  275.  
  276.       - now  the  file's  name,  its  length  etc. are  displayed  when
  277.         scrolling is stopped with <Space>.
  278.       - now left and right mousebutton can be used instead of space and
  279.         backspace.
  280.       - controlcodes aren't displayed anymore.
  281.  
  282.    v1.3:
  283.  
  284.       - Strong  increase in  speed while  scrolling. WarpText  has been
  285.         replaced by  QText (Sorry, Bill).  MuchMore  is  now as fast as
  286.         Blitz (with Video Sync) although it uses a bigger screen.
  287.       - Now supports numeric keypad (home, end, PgUp etc.)
  288.       - Now the screen  gets it's  size from gfxbase^.normalDisplayXXX.
  289.         This way  MuchMore  can  be run  on PAL,  NTSC, Amigas  with an
  290.         Overscan- Workbench (like mine),  and on resolutions that'll be
  291.         used  in  future.  It always  opens  its screen  as big  as the
  292.         current Workbenchscreen.
  293.  
  294.    v1.4:
  295.  
  296.       - Displaying  and  loading  of  the  text  are  now  done  by two
  297.         asynchroneous tasks.  Scrolling is  more  homogeneous  now  and
  298.         there are no more stops to load further text.
  299.       - The feature to display several texts has been removed.
  300.       - Bugs in filelength and end-function removed
  301.       - New commands: find, next, previous to search for strings
  302.       - Scrolling stops when MuchMore's window becomes inactive.
  303.  
  304.    v1.5:
  305.  
  306.       - New command: print text (shift+alt+o)
  307.       - removed all imports to make MuchMore shorter
  308.       - added numeric key 5 to quit
  309.  
  310.    v1.6:
  311.  
  312.       - From this  version on  texts with  different fontstyles  (bold,
  313.         italics, inverse) and different colors can be displayed!
  314.  
  315.    v1.7:
  316.  
  317.       - Now MuchMore is again as fast as MuchMore v1.5 was, although it
  318.         uses 2 bitplanes and uses several fontstyles.
  319.       - Print  (shift+alt+o)  doesn't  crash   anymore  when  you  quit
  320.         MuchMore before printing is complete.
  321.  
  322.    v1.8:
  323.  
  324.       - Bug which occured  when searching for  a string having searched
  325.         for a longer string, removed.
  326.       - Strings found while execution of F, N or P are highlighted now.
  327.       - Added NK0 to display filelength etc.
  328.  
  329.    v2.0:
  330.  
  331.       - Ported MuchMore to OBERON
  332.       - Removed bug that caused RMB not  to work on some amigas (it did
  333.         work on my computer)
  334.       - now uses the arp-filerequester
  335.       - new command: L = load new text
  336.  
  337.    v2.1:
  338.  
  339.       - Read-/write-errors used to create some very interesting crashes
  340.         with colorful graphics  and stereo sound.  I'm sorry, but I had
  341.         to remove this.
  342.       - CSI-Codes  have been executed BACKWARDs.  This caused  problems
  343.         with sequences like <CSI>0;4m. Fixed now.
  344.       - New Commands: Ping & Pong, Goto
  345.       - First  page  is  displayed  immediately  now  when  MuchMore is
  346.         started.
  347.  
  348.    v2.2:
  349.  
  350.       - Now MuchMore uses console's keymapping instead of the hardcoded
  351.         one it  used  before.  So  there  won't  be  problems with  any
  352.         japanese keymaps.
  353.  
  354.    v2.3:
  355.  
  356.       - New   command: 's'  (sleep)   and  pop  up  function  lAlt+ESC.
  357.         'MuchMore -s' sleeps immediately.
  358.       - Bug in interpretation of <CSI>[m fixed.  <CSI>[m is now treated
  359.         as <CSI>[0m.
  360.  
  361.    v2.4:
  362.  
  363.       - New Command: 'w' to write block to file or priner
  364.       - Argumentparser rewritten. Now supports quotes.
  365.  
  366.    v2.5:
  367.  
  368.       - Uses 8x8 Font set with SetFont instead of topaz 8.
  369.       - Allocates 4K Memory chunks instead  of one memorychunk for each
  370.         line.  So MuchMore  won't scatter  the Memory anymore.  Another
  371.         positive effect  is that MuchMore  needs less nemory now (about
  372.         14 Bytes per line).
  373.  
  374.  
  375. ---  Fridtjof.
  376.